home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Development / General / PObj->PPob Folder / PObj->PPob Release Notes < prev   
Text File  |  1994-03-31  |  3KB  |  66 lines
  1. PObj->PPob Release Notes
  2.  
  3. version 1.0
  4. 03-30-94
  5.  
  6. Gregory Dow
  7. Metrowerks
  8.  
  9.  
  10. This program converts PowerPlant version d5 & d6 (DR1 CodeWarrior) 'PObj'
  11. resources to PowerPlant d7 (DR2 CodeWarrior) 'PPob' resources.
  12.  
  13. The resource format that PowerPlant uses to describe Panes was changed in
  14. version d7 for several reasons, among them:
  15.  
  16.     - 'PPob' resources have a Rez template. It was not possible to completely
  17.         define a 'PObj' resource with a Rez template.
  18.     - 'PPob' resource format is easier to extend for user-defined Panes
  19.     - 'PPob' resource is more compact
  20.  
  21.  
  22. Using the Converter
  23. -------------------
  24.  
  25. (1) Drag and drop file(s) containing 'PObj' resources onto the program icon
  26.  
  27. (2) The converter program will create separate file(s) which contain
  28.         the converted 'PPob' resources. The file(s) will have the same
  29.         name as the original file with a ".PPob" suffix appended. The
  30.         .PPob file(s) will be ResEdit resource files. Each 'PPob' resource
  31.         will have the same ID number, name, and attributes of the
  32.         corresponding 'PObj' resource.
  33.         
  34. (3) Using a resource editor, copy the 'PPob' resources into your project
  35.         resource file. The old 'PObj' resources are no longer needed
  36.         and can be deleted. (But you may want to keep a copy of the
  37.         old 'PObj' resources for reference).
  38.         
  39.  
  40. Known Limitations
  41. -----------------
  42.  
  43. - This is a quick-and-dirty utility. It does not check for error conditions
  44.     such as locked or full disks. The program may "hang" when reading a
  45.     corrupted or invalid 'PObj' resource. The program should complete
  46.     execution in a couple of seconds. If it takes longer, it has probably
  47.     "hung" and you should abort the program by hitting command-option-escape.
  48.     
  49. - The program will delete any existing target file. For example, if you
  50.     convert a file named "MyResources", the converter will create a
  51.     file called "MyResources.PPob', deleting any existing file with that name.
  52.  
  53. - The program does not handle custom data types. If you extended the 'PObj'
  54.     resource format to define your own objects and associated data, the
  55.     program will do its best to skip over your custom objects, converting
  56.     them into 'null' objects. However, since there is no way for the program
  57.     to determine the size of your custom objects, this may generate
  58.     incorrect results. When trying to skip over custom data, the program
  59.     scans for 'End.' tags. This works in some, but not all, cases.
  60.  
  61. NOTE: The converter program was written using the AppleEvent, File, and
  62.     Stream classes of PowerPlant, using the "Dropper" sample program
  63.     as a starting point. (The "Dropper" sample program is included with
  64.     PowerPlant on the DR2 CodeWarrior CD-ROM.)
  65.  
  66.